home *** CD-ROM | disk | FTP | other *** search
/ MacHack 1996 / MacHack 1996.toast / Hacks / Hacks '96 / watrend / Read Me next >
Encoding:
Text File  |  1996-06-21  |  2.0 KB  |  75 lines  |  [TEXT/CWIE]
  1. About WatRend
  2. -------------
  3.  
  4. By: Gavriel State
  5.     gav@magmacom.com
  6.     http://www.magmacom.com/~gav
  7.  
  8. WatRend is a portable 3D rendering engine.  It's run on at least 
  9. 5 different OSes (MacOS, x86 DOS, Linux/X, Be OS, and IRIX/GL),  
  10. and at least 4 different CPUs (68K, PPC, x86, MIPS).  It's a 
  11. fairly primitive scanline-style renderer, intended to serve as 
  12. a platform for playing with scanline algorithms.  At least one
  13. alternate algorithm has already been plugged in.
  14.  
  15. WatRend was started in December 1994, and has gone through a 
  16. couple of revs since then.
  17.  
  18. I did the BeOS port here at MacHack in about 3 hours, having
  19. never seen a Be Machine before.  It was easier than the other
  20. ports in some respects (very easy bitmap, view, and windowing
  21. classes), and harder in others (I had to completely rip out 
  22. the event loop core of the main program and replace it with a 
  23. threaded, message based input model).  A very cool machine, 
  24. overall.  At the same time, it was a *very* quick port, so 
  25. the view class is really skanky and full of cut-and-pasted
  26. globals.
  27.  
  28. Running WatRend
  29. ---------------
  30.  
  31. WatRend requires input from a command line (the MacOS version 
  32. has a little startup dialog to get the input).  The command 
  33. structure is:
  34.  
  35.     WatRend [PLG file] [size] [#objects]
  36.  
  37. PLG File is the path to a Rend386 style .PLG file.
  38.  
  39. Size is the size multiplier for the object.  Start with 1 and 
  40. experiment from there.
  41.  
  42. #objects is the number of objects to create in the sample.
  43. Actually, it's *half* the number of objects to create; each 
  44. object has a child object that orbits it.
  45.  
  46.  
  47. Examples:
  48.  
  49. WatRend ../../plg/torus1.plg 1 1
  50. WatRend ../../plg/box.plg 0.2 4
  51.  
  52.  
  53. Within watrend the following keys are active:
  54. i - pitch down
  55. k - pitch up
  56. j - roll left
  57. l - roll right
  58. o - accellerate
  59. u - decellerate
  60. space - stop
  61.  
  62.  
  63. y,t,g,h,b,n - control the objects' rotation.
  64. r - stop object rotation
  65.  
  66. a - dim lights
  67. s - brighten lights
  68.  
  69. f - flip backface/foreface removal
  70.  
  71. d - hi-res/lo-res toggle
  72.  
  73. c (Mac only) - toggle CopyBits/Direct-To-Screen drawing.
  74.  
  75.